home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Network Support Library
/
RoseWare - Network Support Library.iso
/
mhs
/
uaio10.exe
/
AIODGXI.DOC
< prev
next >
Wrap
Text File
|
1992-12-02
|
25KB
|
725 lines
DigiBoard
6400 Flying Cloud Drive
Eden Prairie, MN 55344
(612) 943-9020
Installation Guide
and
Reference Manual
for
DigiCHANNEL PC/Xe, PC/Xi, MC/Xi
Novell AIO Driver
DBI 92000115B
DigiBoard, DigiCHANNEL, PC/Xe, PC/Xi and MC/Xi are trademarks of
DigiBoard. NetWare, NetWare Access and Novell are registered
trademarks of Novell, Incorporated. All other brand and product
names are the trademarks of their respective holders.
Copyright (c) Digi International, Inc 1992
All Rights Reserved
Information in this document is subject to change without notice
and does not represent a commitment on the part of DigiBoard.
DigiBoard provides this document "as is", without warranty of any
kind, either expressed or implied, including, but not limited to,
the particular purpose. DigiBoard may make improvements and/or
changes in this manual or in the product(s) and/or the program(s)
described in this manual at any time.
This product could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein;
these changes may be incorporated in new editions of the publication.
RESTRICTED RIGHTS:
For non-U. S. Government use:
These programs are supplied under a license. They may be used,
disclosed, and/or copied only as permitted under such license
agreement. Any copy must contain the above copyright notice and
this restricted rights notice. Use, copying, and/or disclosure
of the programs is strictly prohibited unless otherwise provided
in the license agreement.
For U.S. Government use:
Use, duplication, or disclosure by the Government is subject to
restrictions as set forth in sub-paragraph (c)(1)(ii) of the
Rights in Technical Data and Computer Software clause of DFARS
52.227-7013.
1.0 Introduction
1.1 Overview
DigiBoard's support for Novell compatible asynchronous
applications is provided through a universal driver
conforming to the "AIO" (Asynchronous Input/Output)
specification. Use the AIO driver when DigiBoard hardware
is being installed in the file server (or machine with run-
time NetWare 3.X). When DigiBoard hardware is installed in
a machine other than the server (for instance NetWare Access
Server v1.2) use the specific driver for that application.
AIO drivers are loaded on the file server from the system
console (or RCONSOLE) command line or the AUTOEXEC.NCF file.
Installation is simply a matter of copying of the driver
files AIODGXI.NLM and AIODGMEM.NLM.
1.2 Compatibility
The DigiBoard AIO driver supports the DigiCHANNEL PC/Xi,
PC/Xe and MC/Xi boards and therefore can be used on ISA,
EISA and MCA servers.
The driver will support up to 7 DigiCHANNEL PC/Xe or PC/Xi
boards on ISA and EISA bus servers. These DigiCHANNEL
boards may be configured to use the same memory address
("stacked") or may be configured for unique addresses. The
driver supports both 64k and 128k versions, although your
server may not have an open memory space for the 128k
DigiCHANNEL board.
On MCA bus servers the driver will support up to 4 32k
DigiCHANNEL MC/Xi boards. Your server may be limited to 2
boards due to conflicts with the network adapter card and
ESDI hard disk controller.
-3-
2.0 Installation
To install the DigiBoard AIO driver, simply copy the relevant
files to your file server (although the driver can be loaded
from the file server floppy, this will not be a typical way to
set-up a system). The DigiBoard AIO driver files (AIODGXI.NLM
and AIODGMEM.NLM) should both be copied to the system directory
of the file server, typically called F:\SYSTEM. Copy the files
from a workstation to the file server with the commands:
COPY A:\AIODGXI.NLM F:\SYSTEM
and
COPY A:\AIODGMEM.NLM F:\SYSTEM
2.1 PC/Xe and PC/Xi Installation
DigiCHANNEL PC/Xe and PC/Xi boards may be installed in either
ISA or EISA platforms. In either case, the driver must be
loaded for each board you wish to support. The syntax for
loading the driver is as follows:
load aiodgxi port=xxx mem=xxxxx [name=bname] [node=0]
[altp[=mask]]
port=xxx This parameter is the board's 3 digit hex I/O
port address.
For example: port=320.
Valid port addresses are 100, 110, 120, 200, 220,
300 and 320.
Each board must have a unique I/O port address, which
must not be used by any other device in the system.
mem=xxxxx This parameter is the 5 digit hex starting address of
the DigiCHANNEL board's dual-ported memory.
For example: mem=d0000.
Memory addresses supported by the driver are
80000, 90000, A0000, B0000, C0000, and D0000.
Typically C0000 and D0000 will be the only
addresses available in your server.
All PC/Xe and PC/Xi boards may share the same
memory addresses, since only one board's
memory is turned on at a time.
name=bname: This parameter is optional and allows you to
specify up to a 10 character name to identify
the board. bname may consist of any combination
of alphanumerical characters. If you do not
specify a name, one will be assigned by the driver.
Following is a list of the board's I/O port
addresses and the associated default names and
board numbers.
-4-
Port Default Board
Address Name Number
------- -------- ------
100h DigiXi00 0
110h DigiXi01 1
120h DigiXi02 2
200h DigiXi03 3
220h DigiXi04 4
300h DigiXi05 5
320h DigiXi06 6
node=0 This parameter must be used if you are using
AIO.NLM version 1.0.2 or earlier. These
versions of AIO need sequential board numbers
based on the load order of the driver. (The
first board loaded will be assigned #0, the
second board will be assigned #1 and so on.)
Using the node=0 parameter informs the driver
to assign board numbers sequentially. If
this parameter is excluded, the driver will
assign board numbers based on the I/O port
address as defined above.
Note: The word node in the above parameter must be
entered using only lowercase letters.
altp: The standard wiring for DigiCHANNEL boards
equipped with RJ-45 connectors places the
modem control lines RI (Ring Indicator) and
DCD (Data Carrier Detect) on pins 1 and 10,
respectively, which makes them inaccessible
to an 8-pin RJ-45 plug. While RI is seldom
used, DCD is necessary for most modem applica-
tions. To facilitate the use of 8-pin RJ-45
plugs, a software feature called "ALTPIN" has
been included with this device driver. When
ALTPIN is active, DCD is swapped with DSR
(Data Set Ready), which is on pin 1 of an 8-
pin RJ-45 plug.
This parameter is optional and allows you to
specify that you want to activate the driver's
ALTPIN option. When this parameter is entered
as just "altp", all ports on the board will
operate with the ALTPIN option active. When
entered as "altp=mask" the driver uses the hex
mask to determine which ports will use the ALTPIN
feature. See example on next page:
-5-
altp=f0
F0 (hex) = 11110000 (binary)
||||||||
|||||||+----Port 1
||||||+-----Port 2
|||||+------Port 3
||||+-------Port 4
|||+--------Port 5
||+---------Port 6
|+----------Port 7
+-----------Port 8
This will activate ALTPIN on the board's last
four ports. The mask can be up to 4 hex
digits long to activate ALTPIN on up to 16
ports.
IMPORTANT! IRQs on PC/Xe and PC/Xi boards should be
disabled. Set all eight switches in DIP switch bank
DS2 to "ON" (pressed up away the board).
-6-
2.1.1 PC/Xe and PC/Xi DIP Switch Settings
Memory Start Address:
DS1, Switch 1 2 3 4 5 6 7 8
Address --- --- --- --- --- --- --- ---
080000h ON ON ON OFF ON ON ON ON
090000h OFF ON ON OFF ON ON ON ON
0A0000h ON OFF ON OFF ON ON ON ON
0B0000h OFF OFF ON OFF ON ON ON ON
0C0000h ON ON OFF OFF ON ON ON ON
0D0000h OFF ON OFF OFF ON ON ON ON
I/O Port Address:
DS1, Switch 9 10 11
Address --- --- ---
100h ON OFF OFF
110h OFF ON OFF
120h ON ON OFF
200h OFF OFF ON
220h ON OFF ON
300h OFF ON ON
320h ON ON ON
IRQ:
DS2, Switches 1-8
Set all switches in DS2 to "OFF" (interrupts disabled).
-7-
2.2 MC/Xi Installation
The driver will also support up to 4 DigiCHANNEL MC/Xi
boards on MCA (Micro Channel) bus servers.
2.2.1 Configuring the MC/Xi for 32K Operation
Due to memory restrictions, the MC/Xi boards must be
set for 32K operation. This is accomplished by changing
a jumper, J1, on the board. J1 must be installed between
pins 2 and 3 (the right-hand two pins).
Please note that only the newer MC/Xi boards (Part
#30001224) are supported by this software. The part
number can be found next to the serial number of the
Processor board (the MC/Xi board is actually two boards
joined together. The Processor board is the bottom
segment, which plugs into the Micro Channel slot):
Jumper J1 is located above the MC/Xi board's edge
connector.
2.2.2 Loading the AIO Driver
There are two ways to load the driver on these servers:
You may load the driver for one board at a time or you
may autoload the driver for all boards in the system.
The syntax for loading the driver is as follows :
load aiodgxi[port=xxxx mem=xxxxx [name=bname]] [node=0]
altp[=mask[,mask[,mask[,mask]]]]]
port=xxxx This parameter is optional and specifies the
MC/Xi board's 4 digit hex I/O port address.
For example : port=F1F0
Valid port addresses are F1F0, F2F0, F4F0 and
F8F0.
This parameter is used when you are loading
the driver to support just one specific board
and must be used with the parameter "mem=".
If you do not use these two parameters, the
driver will autoload support for all MC/Xi
boards found in the system.
-8-
mem=xxxxx This parameter is optional and specifies the
MC/Xi board's 5 digit hex memory starting
address.
For example : mem=d0000
Memory addresses supported by the driver are
C0000, C8000, D0000 and D8000. This
parameter is used when you are loading the
driver to support just one specific board and
must be used with the parameter "port=". If
you do not use these two parameters, the
driver will autoload support for all MC/Xi
boards found in the system.
name=bname: This parameter is optional when using the
"mem=" and "port=" parameters, and allows you
to specify up to a 10 character name to
identify the board. bname may consist of any
combination of alphanumerical characters. If
you do not specify a name, one will be
assigned by the driver. Following is a list
of the board's I/O port addresses and the
associated default names and board numbers.
Port Default Board
Address Name Number
------- -------- ------
F1F0h DigiXi00 0
F2F0h DigiXi01 1
F4F0h DigiXi02 2
F8F0h DigiXi03 3
node=0 This parameter must be used if you are using
AIO.NLM version 1.0.2 or earlier. These
versions of AIO need sequential board numbers
based on the load order of the driver. (The
first board loaded will be assigned #0, the
second board will be assigned #1 and so on.)
Using the node=0 parameter informs the driver
to assign board numbers sequentially. If
this parameter is excluded, the driver will
assign board numbers based on I/O port
address as defined above.
Note: The word node in the above parameter must be
entered using only lowercase letters.
altp: The standard wiring for DigiCHANNEL boards
equipped with RJ-45 connectors places the
modem control lines RI (Ring Indicator) and
DCD (Data Carrier Detect) on pins 1 and 10,
respectively, which makes them inaccessible
to an 8-pin RJ-45 plug. To facilitate the
use of 8-pin RJ-45 plugs, a software feature
called "ALTPIN" has been included with this
device driver. When ALTPIN is active, DCD is
swapped with DSR (Data Set Ready), which is
on pin 1 of an 8-pin RJ-45 plug.
-9-
This parameter is optional and allows you to
specify that you want to activate the driver's
ALTPIN option. When this parameter is entered
as just "altp", all ports on the board will
operate with the altpin option active. When
entered as "altp=mask" the driver uses the hex
mask to determine which ports will use the
ALTPIN feature. For example :
altp=f0
F0 (hex) = 11110000 (binary)
||||||||
|||||||+----Port 1
||||||+-----Port 2
|||||+------Port 3
||||+-------Port 4
|||+--------Port 5
||+---------Port 6
|+----------Port 7
+-----------Port 8
This will activate ALTPIN on the board's last
four ports.
When autoloading support for all DigiCHANNEL
boards in the server, you may specify up to
four masks, one for each possible board. For
example:
altp=1,8,10,80
1 (hex) = 00000001 (binary)
8 (hex) = 00001000 (binary)
10 (hex) = 00010000 (binary)
80 (hex) = 10000000 (binary)
||||||||
|||||||+----Port 1
||||||+-----Port 2
|||||+------Port 3
||||+-------Port 4
|||+--------Port 5
||+---------Port 6
|+----------Port 7
+-----------Port 8
In this example the first port on the first
board, the fourth port on the second board,
the fifth port on the third board and the
eighth port on the fourth board will use
ALTPIN. The mask can be up to 4 hex digits
long to activate ALTPIN on up to 16 ports.
-10-
When autoloading, the driver uses the MCA
bus's POS (Programmable Option Select)
capabilities to determine the MC/Xi boards
that are installed in your server, starting
with slot 1. The first ALTPIN mask will
activate ALTPIN on the board in the lowest
numbered slot, the second mask for the next
lowest slot, and so on.
-11-
3.0 Error Messages
The following error messages may occur while the driver is
parsing the parameters.
*Usage Error: AIODGXI port=XXXX mem=XXXXX [name=bname].
This error will appear if you load the driver with no
parameters on ISA and EISA bus servers.
*Usage Error: First parameter not 'port='.
The driver expects the first parameter to be port=xxxx,
but this was not the case.
*Error: Invalid Port Address 0x310.
This message indicates that an invalid port address was
specified.
*Error: Port Address 0x320 is already supported.
This message indicates that the driver is already
supporting a DigiCHANNEL board at this port address.
*Usage Error: Second parameter not 'mem='
The driver expects the second parameter to be mem=xxxxx,
but this was not the case.
*Error: Invalid Memory Address 0xF0000.
This message indicates that an invalid memory address was
specified.
*Error: Memory Address 0xC0000 is already supported.
This message indicates that the driver is already supporting
a DigiCHANNEL board at the specified memory address. This
message will only be seen on MCA bus servers since MC/Xi
boards must use different memory addresses.
The following error messages may occur while the driver is
performing some initial tests on the DigiCHANNEL board.
Board 4: Port 220 Mem D0000 Port 220 not found.
This message indicates that the driver could not find a
board with port 220h. Check to insure that you have
specified the correct I/O port or that you have properly
configured the board's port address.
Board 4: Port 220 Mem D0000 Hardware Reset Fails.
This message indicates that the driver could not place
the board into a reset state. This is most likely the
result of an I/O port address conflict or a faulty board.
Be sure that there are no other I/O ports in your system
at the indicated I/O port address.
Board 4: Port 220 Mem D0000 PC/Xi Memory size too Large.
This message indicates that your PC/Xi board has more
than 128k and is not supported by the driver.
-12-
Board 4: Port 220 Mem D0000 Memory not found error x.
This message indicates that the driver could not find the
board's memory. x indicates the number of memory errors
found in a 256 byte block.
Board 4: Port 220 Mem D0000 Memory error x.
This message indicates that the driver has found the
board's memory, but it appears to be faulty. x indicates
the number of errors found in a 256 byte block.
Board 4: Port 220 Mem D0000 Memory fails disable.
This message indicates that the board's memory could not
be disabled. This message will not occur on MC/Xi boards.
The following messages may occur during the drivers attempt to
initialize the board.
Board 4: Port 220 Mem D0000 BIOS fails initialization.
This message indicates that the board's on-board BIOS did
not initialize properly.
Board 4: Port 220 Mem D0000 BIOS passes init but reports 0 ports.
This message indicates that the BIOS initialized successfully,
but could not find any of the asynchronous channels.
Board 4: Port 220 Mem D0000 NMI Fails during FEPOS code move.
This message indicates a failure during transfer of the
on-board operating system code.
Board 4: Port 220 Mem D0000 NMI Fails during FEPOS execution.
This message indicates a failure during startup of the
on-board operating system.
Board 4: Port 220 Mem D0000 FEPOS Fails Initialization.
This message indicates that the on-board operating system
did not initialize successfully.
Board 4: Port 220 Mem D0000 Command failure during Initialization.
This message indicates that the on-board operating system
encountered a failure during initialization of the asynchronous
channels.
-13-